home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / bbs / day910_1.zip / NEWDAY49.ZIP / NEWDAYPC.DOC < prev    next >
Text File  |  1995-03-24  |  30KB  |  542 lines
  1. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  2. = NewDayPC - Mike Ratledge, 995 Buck Hall Landing, McClellanville, S.C. 29464 =
  3. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  4.   = Version 4.90 - Released March 24th, 1995 - (C) CopyRight 1989 thru 1995 =
  5.   =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  6.  
  7.       This program performs similar functions, and accepts the same 
  8.     datafiles as "Today" (Patricks Kincaid's original history program).  
  9.     I wrote "NewDayPC" because I really liked Patrick's program, but was 
  10.     unable to use it on my BBS due to file-sharing conflicts.  At the 
  11.     time I released "Today/PC II vers 1.0", Patrick had not changed his 
  12.     program in several years, I (not anyone else) was able to contact him
  13.     for many months (years?), and I assumed it was a "dead" project for 
  14.     him.  However, Patrick did release follow-up versions (latest being 
  15.     TODAY version 2.3?), and decided that my program's name was "too 
  16.     similar."  So, as of version 4.0, I renamed Today/PC II to 
  17.     NewDay/PC. 
  18.     
  19.       Although I've never had a serious bug reported by any user of 
  20.     Newday/PC, it is possible that some unexpected combination of events 
  21.     may produce an error!  If this does happen, Newday/PC automatically 
  22.     does a traceback through stack code to show the calling procedure 
  23.     tree and addresses.  Please include this information if you report a 
  24.     bug!  (It appears similar to the error message normally seen in a 
  25.     failed "Turbo Pascal" program, except it will contain at least three 
  26.     or four sets of codes instead of one address & error number.) 
  27.     
  28.       This program is part of a series of utilities for TComm Bulletin 
  29.     Board SysOps.  The program originally designed by Patrick Kincaid 
  30.     known as "Today" (which was written in 1986) was my inspiration.  I 
  31.     have taken his concept and extended it to accommodate my needs as a 
  32.     SysOp.  It works equally well as a 'stand-alone' program for personal
  33.     use, as long as you have an ANSI.SYS-compatible device driver in your
  34.     CONFIG.SYS file (see 'updates to version 4.9, below).
  35.     
  36.       My original version corrected some drawbacks with Kincaid's 
  37.     original Today. 
  38.          .  Handles files larger than 50K
  39.          .  Handles more than 60 entries per date
  40.          .  Incorporates full DOS 3+ (network-compatible) file-sharing
  41.             for the multi-user Bulletin Board Systems
  42.     The filesize isn't limitted at all, in fact - you can use as large a 
  43.     database as you wish, with as many entries per day as you can find!  
  44.     Multiple concurrent accesses to databases are supported for 
  45.     networks, as well.  Note that in a multi-user environment, it would 
  46.     be unadvisable to use the "ONCE" option and expect it to work with 
  47.     any consistency, since multiple stations would update the file 
  48.     timestamp. 
  49.     
  50.       The actual data displayed by "Newday/PC" is taken from files 
  51.     compiled by Bruce T Goldman and Robert Braunwart.  These files are 
  52.     distributed on bulletin boards as DAY9*.ARC. All the formats & 
  53.     parameters in the original program ("TODAY") written by Patrick, 
  54.     work the same as before. There are many new parameters, as well (See 
  55.     below).  The basic coding of the input database is discussed later 
  56.     in this document.  I also explain the new features and coding 
  57.     changes. Type "NEWDAYPC HELP" for a fast "tutorial." 
  58.     
  59.       In order to keep the archive size down to a minimum, I only 
  60.     include the program and docs.  The TODAY database files are 
  61.     available for download from many bulletin board at numbers below. 
  62.     
  63.     NOTE: 
  64.        I use a simple parsing routine to check the command-line 
  65.     parameters, and I don't recognize mixed-case parameters - just all 
  66.     upper- or lower-case letters on the command-line.  Color parameters 
  67.     may be mixed upper and lower, though. 
  68.     
  69.     
  70.     
  71.     
  72.     
  73.     Listing of enhancements in reverse order... 
  74.     
  75.     
  76.     Changes in version 4.9: (Mar 24, 1995)
  77.  
  78.       Version 4.9 is a complete rewrite of "NewDay/PC" from the ground up,
  79.     and it's the first new version released since Hurricane Hugo destroyed
  80.     the source-code and both my homes September 21st, 1989.  It basically
  81.     should work exactly like 4.5, but the "A.S.P." author logos have been
  82.     removed and method of payment can no longer be 'plastic' - I have not
  83.     been able to justify keeping the "Merchant Account" open.  Please send
  84.     a personal check or a bank-check (or money order) written in US$ payable
  85.     on a bank in the US, or a postal money order.  A small temporary fix in
  86.     the form of "EAT-WHYS.EXE" is included to strip any "Y" type database
  87.     entries from Bruce Goldman's latest (by my records "DAY908-x.ZIP" where
  88.     'x' is '1' thru '6') version which are not properly supported by this
  89.     version, although version 5.0 will correct this problem.  Run "EAT-WHYS"
  90.     once - it will 'clean' your TODAY.xxx databases until I get a chance to
  91.     implement the changes necessary to support this new functionality.  (I
  92.     expect version 5.0 will be out mid-year, time allowing)  Note that since
  93.     NewDay/PC was originally written for usage by bulletin boards, currently
  94.     it requires an ANSI.SYS (or replacement) driver to be loaded in your
  95.     CONFIG.SYS file.  You may eliminate this necessity (although you will
  96.     also eliminate color output) by putting "NOCOLOR" on the command-line.
  97.     Version 5 will work with or without an ANSI.SYS-compatible device driver
  98.     so it can be used as a BBS door or a free-standing program equally well.
  99.     If you're not a documentation reader and anxious to just use the program
  100.     type "NEWDAYPC /?" for command-line options and you're off!  Remember -
  101.     if you get updated databases, and version 5 still isn't available, you
  102.     will need to run "EAT-WHYS.EXE" again (once).  It doesn't actually take
  103.     any entries out - just makes NewDay/PC ignore those it doesn't handle
  104.     properly...  (and is reversible when 5.0 comes out!)
  105.  
  106.  
  107.     Changes in version 4.5: (Feb 5, 1989) 
  108.     
  109.       Version 4.5 basically incorporates two changes:  the addition of 
  110.     three new event catagories - "H" for Holidays, "I" for Religious 
  111.     occurances and "D" for deaths.  This allows the database to be 
  112.     further diversified with many more events, without lumping them all 
  113.     into one category.  Bruce Goldman is going to issue completely new 
  114.     version 9, TODAY.xxx files, all of which are available on EBX (phone 
  115.     numbers above) to go with this version.  Secondly, I fixed the "span 
  116.     date" feature so that it works even if the beginning of the period 
  117.     is not in the current months (that's a *feature* - Nope!  That was a 
  118.     bug <grin>...).  Note that the limiting used by the randomizing code 
  119.     still only effects types "B" (birthdates) and type "S" historical 
  120.     events. 
  121.     
  122.       I have also expanded the header data to accept up to 72 characters 
  123.     to permit use of ansi-color. 
  124.     
  125.       Also, there is code added specifically for use with TComm/TCommNet 
  126.     systems which detects whether or not the caller is in ANSI Color 
  127.     mode or not.  If the current caller on the BBS is not in color mode, 
  128.     the display is in all black and white. 
  129.     
  130.     
  131.     What's new in version 4.0: (Oct 16, 1988) 
  132.     
  133.       Name Change (NewDay/PC)  Starting with version 4.0, this program 
  134.     has been renamed "NewDay/PC" in order to cause less confusion with 
  135.     Patrick Kincaid's Today program. 
  136.     
  137.       Slight Mod:  (Check for .EXE)  Since I have renamed the program 
  138.     "NEWDAYPC" I now look for either NEWDAYPC.EXE or TODAY.EXE instead 
  139.     of TODAY & TODAYPC2 .EXE files for the file-sharing test.  In other 
  140.     words - you can rename this program "TODAY.EXE" and the file-sharing 
  141.     check still works - but you can't use the old "TODAYPC2.EXE" name 
  142.     any more - it doesn't check for that one. This only effects people